home *** CD-ROM | disk | FTP | other *** search
/ Informática Multimedia 1995 April / Informatica Multimedia CD - Epimundo.iso / DOS / ARCHIVE / ZOO / FIZ.MAN < prev    next >
Encoding:
Text File  |  1990-07-16  |  4.1 KB  |  98 lines
  1.  
  2.  
  3. FIZ(1)              **IX Programmer's Manual               FIZ(1)
  4.  
  5.  
  6.  
  7.  
  8.  
  9. NAME
  10.  
  11.      fiz - analyze damaged zoo archive for data recovery
  12.  
  13.  
  14.  
  15. SYNOPSIS
  16.  
  17.      fiz archive[.zoo]
  18.  
  19.  
  20.  
  21. DESCRIPTION
  22.  
  23.      Fiz is used to analyze damaged zoo archives and locate
  24.  
  25.      directory entries and file data in them.  The current ver-
  26.  
  27.      sion of fiz is 2.0 and it is meant to be used in conjunction
  28.  
  29.      with zoo version 2.0.  Fiz makes no assumptions about
  30.  
  31.      archive structure.  Instead, it simply searches the entire
  32.  
  33.      subject archive for tag values that mark the locations of
  34.  
  35.      directory entries and file data.  In a zoo archive, a direc-
  36.  
  37.      tory entry contains information about a stored file such as
  38.  
  39.      its name, whether compressed or not, and its timestamp.  The
  40.  
  41.      file data are the actual data for the archived file, and may
  42.  
  43.      be either the original data, or the result of compressing
  44.  
  45.      the file.
  46.  
  47.  
  48.  
  49.      For each directory entry found, fiz prints where in the
  50.  
  51.      archive it is located, the directory path and filename(s)
  52.  
  53.      found in it, whether the directory entry appears to be cor-
  54.  
  55.      rupted (indicated by [*CRC Error*]), and the value of the
  56.  
  57.      pointer to the file data that is found in the directory
  58.  
  59.      entry.  For each block of file data found in the archive,
  60.  
  61.      fiz prints where in the archive the block begins.  In the
  62.  
  63.      case of an undamaged archive, the pointer to file data found
  64.  
  65.      in a directory entry will correspond to where fiz actually
  66.  
  67.      locates the data.  Here is some sample output from fiz:
  68.  
  69.  
  70.  
  71.      ****************
  72.  
  73.          2526: DIR  [changes] ==>   95
  74.  
  75.          2587: DATA
  76.  
  77.      ****************
  78.  
  79.          3909: DIR  [copyrite] ==> 1478
  80.  
  81.          3970: DATA
  82.  
  83.          4769: DATA
  84.  
  85.      ****************
  86.  
  87.  
  88.  
  89.      In such output, DIR indicates where fiz found a directory
  90.  
  91.      entry in the archive, and DATA indicates where fiz found
  92.  
  93.      file data in the archive.  Filenames located by fiz are
  94.  
  95.      enclosed in square brackets, and the notation "==>   95"
  96.  
  97.      indicates that the directory entry found by fiz at position
  98.  
  99.      2526 has a file data pointer to position 95.  In actuality,
  100.  
  101.      fiz found file data at positions 2587, 3970, and 4769.
  102.  
  103.      Since fiz found only two directory entries, and each direc-
  104.  
  105.      tory entry corresponds to one file, one of the file data
  106.  
  107.      positions is an artifact.
  108.  
  109.  
  110.  
  111.      Once the locations of directory entries and file data are
  112.  
  113.      found, the @ modifier to zoo's archive list and extract com-
  114.  
  115.      mands can be used and the archive contents selectively
  116.  
  117.      listed or extracted, skipping the damaged portion.  This is
  118.  
  119.      further described in the documentation for zoo(1).
  120.  
  121.  
  122.  
  123.      In the above case, commands to try giving to zoo might be
  124.  
  125.      x@2526,2587 (extract beginning at position 2526, and get
  126.  
  127.      file data from position 2587), x@3090,3970 (extract at 3090,
  128.  
  129.      get data from 3970) and x@3909,4769 (extract at 3909, get
  130.  
  131.      data from 4769).  Once a correctly-matched directory
  132.  
  133.      entry/file data pair is found, zoo will in most cases syn-
  134.  
  135.      chronize with and correctly extract all files subsequently
  136.  
  137.      found in the archive.  Trial and error should allow all
  138.  
  139.      undamaged files to be extracted.  Also note that self-
  140.  
  141.      extracting archives created using sez (the Self-Extracting
  142.  
  143.      Zoo utility for MS-DOS), which are normally executed on an
  144.  
  145.      MS-DOS system for extraction, can be extracted on non-MSDOS
  146.  
  147.      systems in a similar way.
  148.  
  149.  
  150.  
  151. SEE ALSO
  152.  
  153.      zoo(1)
  154.  
  155.  
  156.  
  157. BUGS
  158.  
  159.      Random byte patterns can occasionally be incorrectly recog-
  160.  
  161.      nized as tag values.  This occurs very rarely, however, and
  162.  
  163.      trial and error will usually permit all undamaged data to be
  164.  
  165.      extracted.
  166.  
  167.  
  168.  
  169. DIAGNOSTICS
  170.  
  171.      Fiz always exits with a status code of 0.
  172.  
  173.  
  174.  
  175. FUTURE DIRECTIONS
  176.  
  177.      Automation of data recovery from a damaged archive is poten-
  178.  
  179.      tially achievable.  However, since damaged archives occur
  180.  
  181.      only rarely, fiz as it currently stands is unlikely to
  182.  
  183.      change much in the near future.
  184.  
  185.  
  186.  
  187. AUTHOR
  188.  
  189.      Rahul Dhesi
  190.  
  191.  
  192.  
  193.                           Jan 31, 1988
  194.  
  195.